RevolutionVersion 2.0.1Runtime Revolution Ltd. <http://www.runrev.com/>6 June 2003This file contains installation instructions, upgrade information, and last-minute updates.For complete Revolution documentation, open the Revolution application and choose "Revolution Documentation" from the Help menu. For information about changes and improvements to this version, see the file "What's New" in the Revolution folder._______________________________________CONTENTS: What is Revolution? Last-minute updates Upgrading to version 2.0.1: What's new? System requirements Installation on Mac OS & OS X systems Installation on Linux systems
Installation on Unix systems Installation on Windows systems License information and the Starter Kit Version history Contacting Runtime Revolution_______________________________________WHAT IS REVOLUTION?Revolution is an integrated development environment for Mac OS, OS X, Unix, and Windows computers. Using Revolution's user interface layout tools and built-in Transcript programming language, developers can create standalone, double-clickable applications for any supported platform.With Revolution, you use familiar WYSIWYG tools to lay out your user interface, then write the code that ties it all together. Run and test your application right in the development environment. No matter what platform you use for development, a simple Preview command shows you how your application will look in Windows, Unix, or Mac OS. Finally, either release your application as a file distribution that runs in the freely-downloadable Revolution runtime, or build true double-clickable applications for release on each platform you want to support.For more information about what you can do with Revolution and to join Revolution's developer community, visit our web site at <http://www.runrev.com>.LAST-MINUTE UPDATES- A plugin to search the documentation is now available. Choose Development menu > Plugins > Search Revolution Documentation.UPGRADING TO VERSION 2.0.1: WHAT'S NEW?Version 2.0.1 is a bug fix release. There are no new features. See the "What's New" file for details of what was fixed.Version 2.0 is a feature release. Major new features include:- New Mach-O architecture for OS X standalone applications- Scriptable drag and drop- New text capabilities: Unicode, RTF, & improved regular expressions- XML parser and SOAP support- Table and database field types- Easy-to-use report generator- Video recording using QuickTime or Video for Windows- Text to speech- All-new, all-singing, all-dancing debugger- Transcript Cookbook of sample code recipes, extensively annotatedOther changes include:- New sound recording architecture- Enhanced database access- New FTP functionality- Direct access to the clipboardIn addition, the development environment has been extensively improved and updated. OS X users in particular will find that the user interface is more Jaguar-friendly.Important! Whenever you upgrade to a new version, be sure to make a backup copy of all your stack files before saving them with the new version. This ensures that in case of a problem or incompatibility, you can go back to an older version temporarily until the problem is resolved.The format of stack files has not changed between version 1.1.1 and 2.0. This means that you can open and use version 2.0 stack files in version 1.1.1 (as long as the stack file does not contain Unicode text), although features that are new for 2.0 will not work in earlier versions.For detailed information about new features, issues addressed in this version, and known issues, please see the file "What's New" in the Revolution folder, or the topic "About what's new in version 2.0" in the Revolution Encyclopedia in the documentation.SYSTEM REQUIREMENTS(Memory and disk requirements below are for the Revolution development environment, not for applications created by Revolution.)All operating systems require:- 800x600 or larger monitor- 8-bit (256-color) or higher--- Requirements for Mac OS systems ---You can develop on any Mac OS system that includes:- Any 68K or PPC Macintosh or clone- Operating system: Mac OS 7.1 or later- Memory: at least 48M total (128M total recommended) at least 20M free (48M free recommended)- Disk space: 20M free- QuickTime 3.0 or later required for video features (4.1 recommended)--- Requirements for OS X systems ---You can develop on any OS X system that includes:- Any OS X-capable Macintosh- Operating system: OS X 10.0.3 or later- Memory: 128M total- Disk space: 20M free- QuickTime required for video features--- Requirements for Unix & Linux systems ---You can develop on any Unix system that includes:- One of the following operating systems: FreeBSD or BSDI HP-UX 10.20 or later SGI IRIX 5.3 or later Linux Intel 1.2.13 ELF or later AIX 3.2.3 or later Solaris x86 2.5 or later SPARC Solaris 2.3 or later SPARC SunOS 4.1.x or later- Memory: 48M total- Disk space: 20M free- Xanim required for video features--- Requirements for Windows systems ---You can develop on any Windows system that includes:- Operating system: Windows 95, 98, ME, NT, 2000, or XP- Memory: 48M total- Disk space: 20M free- QuickTime 3.0 or later required for video features (4.1 recommended)INSTALLATION ON MAC OS SYSTEMSTo install Revolution on your system, download the file <http://www.runrev.com/revolution/downloads/distributions/2.0/revolution.sit> from the Runtime Revolution web site, then unstuff the file with StuffIt Expander. (You can also download Revolution from the Runtime Revolution FTP site at ftp.runrev.com.) This creates a folder called "Revolution", which contains all components of the development environment. You can place this folder anywhere on your disk.Important! Do not unstuff the file on a Windows system. Unstuffing on a Windows system will not preserve the resource fork, even if you then move the unstuffed folder to a Mac OS system. If you are installing Revolution on a Mac OS or OS X system, you must unstuff the file on a Mac OS or OS X system. Start up the Revolution development environment by double-clicking the Revolution application inside the folder. If you want to uninstall Revolution, simply drag the Revolution folder to the Trash.Note: The first time Revolution starts up, it sets a preference in the File Exchange control panel to associate Revolution files created on other platforms with the application. (Specifically, it maps the extension ".rev" to the creator signature "Revo" and the type signature "RSTK".) This ensures that downloaded Revolution files, and files you copy from PC-formatted media, will be properly registered in the Finder as belonging to Revolution.INSTALLATION ON OS X SYSTEMSTo install Revolution on your system, download the file <http://www.runrev.com/revolution/downloads/distributions/2.0/revolutionosx.dmg>from the Runtime Revolution web site, then double-click the file. (You can also download Revolution from the Runtime Revolution FTP site at ftp.runrev.com.) This mounts a disk image on your desktop. To install Revolution, open the disk image and copy the contents to your Applications folder.Start up the Revolution development environment by double-clicking the Revolution application. If you want to uninstall Revolution, simply drag the Revolution folder to the Trash.--- Installing for Darwin only ---To install Revolution on a Darwin system, download the file <http://www.runrev.com/revolution/engines20/darwin.gz> and decompress it into a directory.The Darwin version of Revolution is intended for development of command-line scripts, and does not support the Revolution development environment or user interface.
INSTALLATION ON LINUX SYSTEMS
To install Revolution on your system, download the file <http://www.runrev.com/revolution/downloads/distributions/2.0/linux.tgz> and gunzip and untar it.
To start up the Revolution development environment, run "./revolution". If you want to uninstall Revolution, simply delete Revolution's directory.
--- RPM Linux installation ---There are two options for installation on Intel-based Linux systems. You can use the Redhat Package Manager (RPM) distribution or the standard .tgz distribution described above.To install the RPM distribution, download the file<http://www.runrev.com/revolution/downloads/distributions/2.0/revolution-2.0.1-1.i386.rpm> from the Runtime Revolution web site.Then install Revolution as root by running the following shell command: rpm -ivh revolution-2.0.1-1.i386.rpmRevolution is installed in the "/opt/" directory. To start up the Revolution development environment, run "revolution-2.0.1". If you want to uninstall Revolution, run the following shell command: rpm -e revolution-2.0
INSTALLATION ON UNIX SYSTEMSTo install Revolution on your system, download the file <http://www.runrev.com/revolution/downloads/distributions/2.0/unix.tgz> and gunzip and untar it.Next download the correct file for your Unix flavor from the table below, then gunzip it: FreeBSD and BSDI: <http://www.runrev.com/revolution/engines/2.0/unix/Bsd.tgz> HP-UX: <http://runrev.com/revolution/downloads/engines/2.0/Hp9k700.gz> SGI IRIX: <http://runrev.com/revolution/downloads/engines/2.0/Iris.gz> AIX: <http://www.runrev.com/revolution/downloads/engines/2.0/rs6000.gz> Solaris x86: <http://www.runrev.com/revolution/downloads/engines/2.0/SolIntel.gz> SPARC Solaris: <http://www.runrev.com/revolution/downloads/engines/2.0/SolSparc.gz> SPARC SunOS: <http://www.runrev.com/revolution/downloads/engines/2.0/SPARC.gz>Note: You can also download these files from the Runtime Revolution FTP site at ftp.runrev.com.After decompressing the correct file for your flavor of Unix, rename it "revolution", and copy it to the folder you previously untarred.To start up the Revolution development environment, run "./revolution". If you want to uninstall Revolution, simply delete Revolution's directory.INSTALLATION ON WINDOWS SYSTEMSTo install Revolution on your system, download the file <http://www.runrev.com/revolution/downloads/distributions/2.0/revsetup.exe>from the Runtime Revolution web site, then double-click the file to install it. (You can also download Revolution from the Runtime Revolution FTP site at ftp.runrev.com.) This creates a folder called "Revolution", which contains all components of the development environment.Start up the Revolution development environment by double-clicking the Revolution application inside the folder, or choose "Programs > Revolution 2.0.1> Revolution 2.0.1" from the Start menu.If you want to uninstall Revolution, remove it using the Add/Remove Programs Control Panel.